Prompt for Text

Description

The Prompt for Text action will prompt the user for text and store it in a variable.

Procedure

  1. Enter the title of the dialog box in the Dialog Title field. This can be static text or an expression that resolves to a character value. Optionally, click the 'xy' button to open the Expression Builder.

  2. Optionally, enter text into the Prompt field that will appear above the text input field. This can be static text or an expression that resolves to a character value. Optionally, click the 'xy' button to open the Expression Builder.

  3. Specify the variable in the Variable Name field that will receive the user's text input.

  4. Optionally, enter a default value in the Default Value field. This can be static text or an expression that resolves to a character value. If you do not enter a default value, the box will be blank. Optionally, click the 'xy' button to open the Expression Builder.

  5. Optionally, enter a format in the Format String field. This will control what the user can input. If you use a format string, there must be one format character for each character the user will be allowed to input.

    Format Character
    Description
    L

    Any upper case letter

    l

    Any letter

    #

    Any digit, sign, or decimal

    N

    Any upper case letter, digit, sign or decimal

    n

    Any letter, digit, sign or decimal

    A

    Any upper case letter or digit

    a

    Any letter or digit

    0

    Any digit

    &

    Any character

  6. Click the Test Dialog button to see a preview of what your dialog will look like.

  7. Click Next >.

  8. Optionally modify the comment that describes the action.

  9. Click Finish.

See Also